Posts events in the Operating System event queue.

OSErr PPostEvent (
    EventKind eventCode, 
    UInt32 eventMsg, 
    EvQElPtr *qEl
);

eventCode

A value of type EventKind that indicates the type of event to post into the Operating System event queue. You specify the event kind using one or more of these values defined by “EventMask Constant”: mouseDown, mouseUp, keyDown, keyUp, autoKey, and diskEvt. Do not attempt to post any other type of event in the Operating System event queue.

eventMsg

An unsigned 32-bit integer that contains the contents of the message field for the event that PPostEvent should post in the queue.

qEl

You specify the address of a pointer to an event queue entry in this parameter. PPostEvent returns the event queue entry of the posted event through this parameter.

function result

A result code.

DISCUSSION

In the eventCode and eventMsg parameters, you specify the value for the what and message fields of the event’s event structure. The PPostEvent function fills out the when, where, and modifiers fields of the event structure with the current time, current mouse location, and current state of the modifier keys and mouse button.

The PPostEvent function returns, through the qEl parameter, a pointer to the event queue entry of the posted event. You can change any fields of the posted event by changing the fields of its event queue entry. For example, you can change the posted event’s modifier keys by changing the value of the evtQModifiers field of the event queue entry.

The PPostEvent function posts only events that are enabled by the system event mask. If the event queue is full, PPostEvent removes the oldest event in the queue and posts the new event.

Do not post any events other than mouse-down, mouse-up, key-down, key-up, auto-key, and disk-inserted events in the Operating System event queue. Attempting to post other events into the Operating System event queue interferes with the internal operation of the Event Manager.

In most cases, your application does not need to post events in the Operating System event queue.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

Posting events in the Operating System event queue is not supported in Carbon.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)